home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 15 / CU Amiga Magazine's Super CD-ROM 15 (1997)(EMAP Images)(GB)[!][issue 1997-10].iso / CUCD / Graphics / Ghostscript / source / gsdevice.c < prev    next >
Encoding:
C/C++ Source or Header  |  1997-05-24  |  11.5 KB  |  390 lines
  1. /* Copyright (C) 1989, 1996, 1997 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17. */
  18.  
  19. /* gsdevice.c */
  20. /* Device operators for Ghostscript library */
  21. #include "memory_.h"            /* for memcpy */
  22. #include "gx.h"
  23. #include "gscdefs.h"            /* for gs_lib_device_list */
  24. #include "gserrors.h"
  25. #include "gsstruct.h"
  26. #include "gspath.h"            /* gs_initclip prototype */
  27. #include "gspaint.h"            /* gs_erasepage prototype */
  28. #include "gsmatrix.h"            /* for gscoord.h */
  29. #include "gscoord.h"            /* for gs_initmatrix */
  30. #include "gzstate.h"
  31. #include "gxcmap.h"
  32. #include "gxdevice.h"
  33. #include "gxdevmem.h"
  34.  
  35. /* Include the extern for the device list. */
  36. extern_gs_lib_device_list();
  37.  
  38. /* Finalization for devices: close the device if it is open. */
  39. void
  40. gx_device_finalize(void *vptr)
  41. {    discard(gs_closedevice((gx_device *)vptr));
  42. }
  43.  
  44. /* GC procedures */
  45. #define fdev ((gx_device_forward *)vptr)
  46. private ENUM_PTRS_BEGIN(device_forward_enum_ptrs) return 0;
  47.     case 0: ENUM_RETURN(gx_device_enum_ptr(fdev->target));
  48. ENUM_PTRS_END
  49. private RELOC_PTRS_BEGIN(device_forward_reloc_ptrs) {
  50.     fdev->target = gx_device_reloc_ptr(fdev->target, gcst);
  51. } RELOC_PTRS_END
  52. #undef fdev
  53.  
  54. /* Structure descriptors.  These must follow the procedures, because */
  55. /* we can't conveniently forward-declare the procedures. */
  56. /* (See gxdevice.h for details.) */
  57. public_st_device();
  58. public_st_device_forward();
  59. public_st_device_null();
  60. /* A fake descriptor for devices whose descriptor we can't find. */
  61. gs_private_st_complex_only(st_device_unknown, byte, "gx_device(unknown)",
  62.   0, 0, 0, gx_device_finalize);
  63.  
  64. /* GC utilities */
  65. /* Enumerate or relocate a device pointer for a client. */
  66. gx_device *
  67. gx_device_enum_ptr(gx_device *dev)
  68. {    if ( dev == 0 || dev->memory == 0 )
  69.       return 0;
  70.     return dev;
  71. }
  72. gx_device *
  73. gx_device_reloc_ptr(gx_device *dev, gc_state_t *gcst)
  74. {    if ( dev == 0 || dev->memory == 0 )
  75.       return dev;
  76.     return gs_reloc_struct_ptr(dev, gcst);
  77. }
  78.  
  79. /* Set up the device procedures in the device structure. */
  80. /* Also copy old fields to new ones. */
  81. void
  82. gx_device_set_procs(gx_device *dev)
  83. {    if ( dev->static_procs != 0 )        /* 0 if already populated */
  84.     {    dev->std_procs = *dev->static_procs;
  85.         dev->static_procs = 0;
  86.     }
  87. }
  88.  
  89. /* Initialize a device just after allocation. */
  90. int
  91. gdev_initialize(gx_device *dev)
  92. {    *dev = *(gx_device *)&gs_null_device;
  93.     return 0;
  94. }
  95.  
  96. /* Flush buffered output to the device */
  97. int
  98. gs_flushpage(gs_state *pgs)
  99. {    gx_device *dev = gs_currentdevice(pgs);
  100.     return (*dev_proc(dev, sync_output))(dev);
  101. }
  102.  
  103. /* Make the device output the accumulated page description */
  104. int
  105. gs_copypage(gs_state *pgs)
  106. {    return gs_output_page(pgs, 1, 0);
  107. }
  108. int
  109. gs_output_page(gs_state *pgs, int num_copies, int flush)
  110. {    gx_device *dev = gs_currentdevice(pgs);
  111.     int code;
  112.  
  113.     if ( dev->IgnoreNumCopies )
  114.       num_copies = 1;
  115.     code = (*dev_proc(dev, output_page))(dev, num_copies, flush);
  116.     if ( code >= 0 )
  117.       dev->PageCount += num_copies;
  118.     return code;
  119. }
  120.  
  121. /* Copy scan lines from an image device */
  122. int
  123. gs_copyscanlines(gx_device *dev, int start_y, byte *data, uint size,
  124.   int *plines_copied, uint *pbytes_copied)
  125. {    uint line_size = gx_device_raster(dev, 0);
  126.     uint count = size / line_size;
  127.     uint i;
  128.     byte *dest = data;
  129.     for ( i = 0; i < count; i++, dest += line_size )
  130.     {    int code = (*dev_proc(dev, get_bits))(dev, start_y + i, dest, NULL);
  131.         if ( code < 0 )
  132.         {    /* Might just be an overrun. */
  133.             if ( start_y + i == dev->height ) break;
  134.             return_error(code);
  135.         }
  136.     }
  137.     if ( plines_copied != NULL )
  138.       *plines_copied = i;
  139.     if ( pbytes_copied != NULL )
  140.       *pbytes_copied = i * line_size;
  141.     return 0;
  142. }
  143.  
  144. /* Get the current device from the graphics state. */
  145. gx_device *
  146. gs_currentdevice(const gs_state *pgs)
  147. {    return pgs->device;
  148. }
  149.  
  150. /* Get the name of a device. */
  151. const char *
  152. gs_devicename(const gx_device *dev)
  153. {    return dev->dname;
  154. }
  155.  
  156. /* Get the initial matrix of a device. */
  157. void
  158. gs_deviceinitialmatrix(gx_device *dev, gs_matrix *pmat)
  159. {    fill_dev_proc(dev, get_initial_matrix, gx_default_get_initial_matrix);
  160.     (*dev_proc(dev, get_initial_matrix))(dev, pmat);
  161. }
  162.  
  163. /* Get the N'th device from the known device list */
  164. const gx_device *
  165. gs_getdevice(int index)
  166. {    const gx_device **list;
  167.     int count = gs_lib_device_list(&list, NULL);
  168.  
  169.     if ( index < 0 || index >= count )
  170.       return 0;            /* index out of range */
  171.     return list[index];
  172. }
  173.  
  174. /* Clone an existing device. */
  175. int
  176. gs_copydevice(gx_device **pnew_dev, const gx_device *dev, gs_memory_t *mem)
  177. {    gx_device *new_dev;
  178.     const gs_memory_struct_type_t *std = dev->stype;
  179.  
  180.     /*
  181.      * Because command list devices have complicated internal pointer
  182.      * structures, we allocate all device instances as immovable.
  183.      */
  184.     if ( std == 0 )
  185.       {    /*
  186.          * This is the statically allocated prototype.  Find its
  187.          * structure descriptor, and fill it in if this is the first
  188.          * time we've needed it.  (Right now we always fill it in,
  189.          * for simplicity.)
  190.          */
  191.         const gx_device **list;
  192.         gs_memory_struct_type_t *st;
  193.         int count = gs_lib_device_list(&list, &st);
  194.         int i;
  195.         bool forward = false;
  196.         const gx_device_procs *procs = dev->static_procs;
  197.  
  198.         for ( i = 0; list[i] != dev; ++i )
  199.           if ( i == count )
  200.           {    /* We can't find a structure descriptor for */
  201.             /* this device.  Allocate it as bytes and */
  202.             /* hope for the best. */
  203.             std = &st_device_unknown;
  204.             new_dev = gs_alloc_struct_array_immovable(mem,
  205.                 dev->params_size, gx_device, st,
  206.                 "gs_copydevice(unknown)");
  207.             goto out;
  208.           }
  209.         st += i;
  210.         /*
  211.          * Try to figure out if this is a forwarding device.
  212.          * All printer devices, and no other devices, have
  213.          * a null fill_rectangle procedure; for other devices,
  214.          * we look for a likely forwarding procedure in the vector.
  215.          * The algorithm isn't foolproof, but it's all we've got.
  216.          */
  217.         if ( procs == 0 )
  218.           procs = &dev->std_procs;
  219.         if ( procs->fill_rectangle == 0 ||
  220.              procs->get_xfont_procs == gx_forward_get_xfont_procs
  221.            )
  222.           forward = true;
  223.         if ( forward )
  224.           *st = st_device_forward;
  225.         else
  226.           *st = st_device;
  227.         st->ssize = dev->params_size;
  228.         std = st;
  229.       }
  230.     new_dev = gs_alloc_struct_immovable(mem, gx_device, std,
  231.                         "gs_copydevice");
  232. out:    if ( new_dev == 0 )
  233.       return_error(gs_error_VMerror);
  234.     memcpy(new_dev, dev, dev->params_size);
  235.     new_dev->memory = mem;
  236.     new_dev->stype = std;
  237.     new_dev->is_open = false;
  238.     *pnew_dev = new_dev;
  239.     return 0;
  240. }
  241.  
  242. /* Set the device in the graphics state */
  243. int
  244. gs_setdevice(gs_state *pgs, gx_device *dev)
  245. {    int code = gs_setdevice_no_erase(pgs, dev);
  246.     if ( code == 1 )
  247.       code = gs_erasepage(pgs);
  248.     return code;
  249. }
  250. int
  251. gs_setdevice_no_erase(gs_state *pgs, gx_device *dev)
  252. {    bool was_open = dev->is_open;
  253.     int code;
  254.     /* Initialize the device */
  255.     if ( !was_open )
  256.     {    gx_device_fill_in_procs(dev);
  257.         if ( gs_device_is_memory(dev) )
  258.         {    /* Set the target to the current device. */
  259.             gx_device *odev = gs_currentdevice_inline(pgs);
  260.             while ( odev != 0 && gs_device_is_memory(odev) )
  261.                 odev = ((gx_device_memory *)odev)->target;
  262.             ((gx_device_memory *)dev)->target = odev;
  263.         }
  264.         code = (*dev_proc(dev, open_device))(dev);
  265.         if ( code < 0 ) return_error(code);
  266.         dev->is_open = true;
  267.     }
  268.     pgs->device = dev;
  269.     gx_set_cmap_procs((gs_imager_state *)pgs, dev);
  270.     pgs->ctm_default_set = false;
  271.     if ( (code = gs_initmatrix(pgs)) < 0 ||
  272.          (code = gs_initclip(pgs)) < 0
  273.        )
  274.       return code;
  275.     gx_unset_dev_color(pgs);
  276.     /* If we were in a charpath or a setcachedevice, */
  277.     /* we aren't any longer. */
  278.     pgs->in_cachedevice = 0;
  279.     pgs->in_charpath = (gs_char_path_mode)0;
  280.     return (was_open ? 0 : 1);
  281. }
  282.  
  283. /* Make a null device. */
  284. void
  285. gs_make_null_device(gx_device_null *dev, gs_memory_t *mem)
  286. {    *dev = gs_null_device;
  287.     dev->memory = mem;
  288. }
  289.  
  290. /* Select the null device.  This is just a convenience. */
  291. void
  292. gs_nulldevice(gs_state *pgs)
  293. {    gs_setdevice(pgs, (gx_device *)&gs_null_device);
  294. }
  295.  
  296. /* Close a device.  The client is responsible for ensuring that */
  297. /* this device is not current in any graphics state. */
  298. int
  299. gs_closedevice(gx_device *dev)
  300. {    int code = 0;
  301.     if ( dev->is_open )
  302.        {    code = (*dev_proc(dev, close_device))(dev);
  303.         if ( code < 0 ) return_error(code);
  304.         dev->is_open = false;
  305.        }
  306.     return code;
  307. }
  308.  
  309. /* Install enough of a null device to suppress the page device check */
  310. /* during the execution of a restore/grestore/setgstate. */
  311. void
  312. gx_device_no_output(gs_state *pgs)
  313. {    pgs->device = (gx_device *)&gs_null_device;
  314. }
  315.  
  316. /* Just set the device without reinitializing. */
  317. /* (For internal use only.) */
  318. void
  319. gx_set_device_only(gs_state *pgs, gx_device *dev)
  320. {    pgs->device = dev;
  321. }
  322.  
  323. /* Compute the size of one scan line for a device, */
  324. /* with or without padding to a word boundary. */
  325. uint
  326. gx_device_raster(const gx_device *dev, bool pad)
  327. {    ulong bits = (ulong)dev->width * dev->color_info.depth;
  328.     return (pad ? bitmap_raster(bits) : (uint)((bits + 7) >> 3));
  329. }
  330.  
  331. /* Adjust the resolution for devices that only have a fixed set of */
  332. /* geometries, so that the apparent size in inches remains constant. */
  333. /* If fit=1, the resolution is adjusted so that the entire image fits; */
  334. /* if fit=0, one dimension fits, but the other one is clipped. */
  335. int
  336. gx_device_adjust_resolution(gx_device *dev,
  337.   int actual_width, int actual_height, int fit)
  338. {    double width_ratio = (double)actual_width / dev->width ;
  339.     double height_ratio = (double)actual_height / dev->height ;
  340.     double ratio =
  341.         (fit ? min(width_ratio, height_ratio) :
  342.          max(width_ratio, height_ratio));
  343.     dev->x_pixels_per_inch *= ratio;
  344.     dev->y_pixels_per_inch *= ratio;
  345.     gx_device_set_width_height(dev, actual_width, actual_height);
  346.     return 0;
  347. }
  348.  
  349. /* Set the HWMargins to values defined in inches. */
  350. /* If move_origin is true, also reset the Margins. */
  351. /* Note that this assumes a printer-type device (Y axis inverted). */
  352. void
  353. gx_device_set_margins(gx_device *dev, const float *margins /*[4]*/,
  354.   bool move_origin)
  355. {    int i;
  356.     for ( i = 0; i < 4; ++i )
  357.         dev->HWMargins[i] = margins[i] * 72.0;
  358.     if ( move_origin )
  359.     {    dev->Margins[0] = -margins[0] * dev->MarginsHWResolution[0];
  360.         dev->Margins[1] = -margins[3] * dev->MarginsHWResolution[1];
  361.     }
  362. }
  363.  
  364. /* Set the width and height, updating MediaSize to remain consistent. */
  365. void
  366. gx_device_set_width_height(gx_device *dev, int width, int height)
  367. {    dev->width = width;
  368.     dev->height = height;
  369.     dev->MediaSize[0] = width * 72.0 / dev->x_pixels_per_inch;
  370.     dev->MediaSize[1] = height * 72.0 / dev->y_pixels_per_inch;
  371. }
  372.  
  373. /* Set the resolution, updating width and height to remain consistent. */
  374. void
  375. gx_device_set_resolution(gx_device *dev, floatp x_dpi, floatp y_dpi)
  376. {    dev->x_pixels_per_inch = x_dpi;
  377.     dev->y_pixels_per_inch = y_dpi;
  378.     dev->width = dev->MediaSize[0] * x_dpi / 72.0 + 0.5;
  379.     dev->height = dev->MediaSize[1] * y_dpi / 72.0 + 0.5;
  380. }
  381.  
  382. /* Set the MediaSize, updating width and height to remain consistent. */
  383. void
  384. gx_device_set_media_size(gx_device *dev, floatp media_width, floatp media_height)
  385. {    dev->MediaSize[0] = media_width;
  386.     dev->MediaSize[1] = media_height;
  387.     dev->width = media_width * dev->x_pixels_per_inch / 72.0 + 0.499;
  388.     dev->height = media_height * dev->y_pixels_per_inch / 72.0 + 0.499;
  389. }
  390.